home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 August / Macworld (1999-08).dmg / Shareware World / Utilities / Disk & File / AliasZoo 2.0.8 / AliasZoo and AppleEvents < prev    next >
Text File  |  1996-03-15  |  3KB  |  44 lines
  1. AliasZoo and AppleEvents
  2. ____________________________________
  3.  
  4. Before we begin, let me assure you that if you don't know what AppleEvents are you won't need to read this document. If you do know what they are, and you want to know how they work with AliasZoo, then this is the place.
  5.  
  6. All versions of AliasZoo since version 2.0 have supported the standard four AppleEvents (Open, New, Quit, Print). However, version 2.0.3 added support for a number of new AppleEvents specific to AliasZoo. This document will include a description of these events, along with complete definitions for them (this will likely only interest those who REALLY enjoy playing with AppleEvents).
  7.  
  8. Along with the new events introduced in version 2.0.3, support was added for AppleScript. You can now use AppleScript to write scripts to control almost all of AliasZoo's actions. In fact, if you plan on using AppleScript you can probably avoid reading this document. Instead, start up the AppleScript editor and select "Open Dictionary..." from the editor's File menu. Select AliasZoo, and click "Open". You should now see a complete list of the entire AppleScript syntax for controlling AliasZoo. Have fun!
  9.  
  10. So, without further delay, let's start the show...
  11.  
  12.  
  13.             STANDARD EVENTS SUPPORTED BY AliasZoo
  14.  
  15.  
  16. Open - Starts AliasZoo. Does nothing if AliasZoo is already running.
  17.  
  18. New - Starts AliasZoo. Does nothing if AliasZoo is already running.
  19.  
  20. Quit - Quits AliasZoo.
  21.  
  22. Print - Prints AliasZoo's shareware registration form. Will require AliasZoo to come to the foreground.
  23.  
  24.  
  25.             EVENTS UNIQUE TO AliasZoo
  26.  
  27.  
  28. All events unique to AliasZoo are of the class 'kAZo'.
  29.  
  30. kFindEvent         'AZfd'
  31.         Sending this event to AliasZoo is the same as clicking the Find button.
  32.  
  33. kResolveEvent        'AZrs'
  34.         Sending this event is the same as clicking the Resolve button. When you send this event to AliasZoo it will begin resolving aliases, but it will not display any indication that it is working if it is in the background at the time.
  35.  
  36. kDeleteEvent        'AZdl'    optional parameter:  Boolean 'pDlg'
  37.         Sending this is the same as clicking the delete button. Note that this will only work on alias files that are selected in the display. The boolean parameter 'pDlg' is true if you want AliasZoo to display a confirmation dialog before deleting. If the parameter is not provided, the default is to display a dialog. Also note that requesting AliasZoo to display the dialog will require it to come to the foreground.
  38.  
  39. kVolumeEvent        'AZsw'        required parameter:  Text 'pTo '
  40.         Sending this event, along with a text parameter 'pTo ' (notice that the fourth character is a space), will cause AliasZoo to switch to the volume named by 'pTo '. If you pass the name of a non-existant volume, AliasZoo reports an error and does nothing. Note, you currently cannot set AliasZoo to search a specific folder using AppleEvents.
  41.  
  42. kAttachEvent        'AZat'
  43.         Sending this event is the same as clicking the attach button. Note that this will only work on alias files that are selected in the display. Also note that sending this event will cause AliasZoo to switch to the foreground (or request that the user bring it to the front) so it can display the attach dialog(s).
  44.